SSM 8080 MONITOR V1 


Copyright 1977 by Solid State Music 


FEATURES 
Available in eight 1702's or two 2708's UV PROMs. 
Commands: 


D---~Display a block of memory data between any two addresses 
within 64K of RAM. 


S----Display or Substitute a byte for another anywhere in memory . 
F----Fill an area in memory with a specific byte. 


M---~Move a block of memory data, of any length, from one location 
in RAM to another. | 


B----Dump memory to a punch device in a binary format. This for- 
mat is compatible with MITS paper-tape format. | 


L---~Load a binary tape with an optional bias address. 


W----Dump memory to a punch device in hex checksum format. This 
format is compatible with INTEL paper-tape format. 


R---~Load a hex checksum tape with an optional bias address. 


G----Go to an address and start execution with the option of up 
to two software breakpoints being preset for a powerful 
software debugging tool. 


X----Display the CPU's registers after a breakpoint is encountered. 
Any register data can be modified at will and the program 
resumed. 


A----SSM 8989 Monitor can logically communicate with any four dif- 
ferent physical devices for each of its four main I/0 entry 
points. : 


Entry points for: 
AC = Console I/0 Devices 
AR = Reader Devices 
AP = Punch Devices 
AL Listing Devices 


tt 


The monitor may be easily adapted to any hardware configura- 
tion through redefinition of the "System Configuration Pack- 
age" section of the monitor. 


Starting address of the SSM 8989 Monitor is at FOPPP hex. 
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1.0 SOLID STATE MUSIC 8080 MONITOR V-1 


The Solid State Music 8080 Monitor constitutes a powerful central 
operating system for an 8080 based microcomputer system. The mon- 
itor may be easily adapted to any hardware configuration through 
redefinition of a separately assembled "System Configuration Pack- 
age". 


Together the monitor and the system configuration package occupy 
less that 2048 bytes of memory (ROM) and require less than 64 
bytes of RAM for scratchpad. 


The monitor provides an interface to system peripheral devices 
through externally referenced subroutines and logical I/0 assign- 
ments. Operator commands are inplemented for loading, examining, 
changing and dumping memory, executing user programs with or with- 
out breakpoints, examining/changing register contents, assigning 
physical devices to logical devices, etc. Memory may be loaded 
from or dumped to external files in either hexadecimal or binary 
format. 


The system configuration package serves as an interface between 

the standard monitor and the hardware configuration at a particular 
installation. Consideration is given to a variety of peripheral 
devices and memory organizations. 


Operator Commands 


Operator commands to the monitor consist of a single alphabetic 
character input to the logical console input device and, usually, 
one or more parameters. When two or more parameters are used they 
are separated by a comma or a space. Parameters are hexadecimal 
values consisting of the last four (or two, as appropriate) hex- 
adecimal characters before the parameter is terminated. Leading 
zeros are assumed. 


The command line is terminated by a carriage: return in most cases. 
Any character other than those specified aborts the command. 


Memory Commands 

D Command (display memory) 

D' Low Addeées® Apa oh Address' 

Memory from 'Low Address'through 'High Address' is displayed on the 
logical console output device. If 'High Address' is equal to or 


smaller than 'Low Address' only the byte at ‘Low Address' is dis- 
played. 


Memory Commands (continued) 


Data bytes are displayed in hexadecimal, 16 bytes per line. The 
beginning address of each line is displayed before the line. 


S Command (substitute memory) 
S'Address' 


The byte at location 'Address' is displayed on the logical console 
device followed by a - character. The operator responds with one 
or more characters from the logical console input device. If the 
input character is space or comma, the contents of the next loca- 
tion are displayed, etc. If one or more hexadecimal digits are 
input before the space or comma, the specified value will replace 
the display value in the memory location. A carriage return ter- 
minates the command line. | 


F Command (fill memory) 
F'Low Address','High Address','Data' 


Memory from 'Low Address' through 'High Address' is filled with 
'Data'. If 'High Address' is equal to or smaller than 'Low Add- 
ress' only location 'Low Address' is filled. 


M Command (move memory) 
M'Low Address','High Address','Dest Address' 


Data from 'Low Address’ through 'High Address' are moved to memory 
beginning at 'Dest Address'. If 'High Address' is equal to or 
smaller than 'Low Address' only the byte at ‘Low Address' is moved. 
If 'Dest Address' is between 'Low Address' and 'High Address' the 
data from 'Low Address' to 'Dest Address' is repeated to fill the 
destination field. 


External File Commands 
B Command (binary dump memory) 
B'Low Address','High Address' 


Data from 'Low Address! through 'High Address' are output to the 
logical punch device in a binary format compatible with mits paper 
tape format. ' High Address' must be equal to or greater than 
'Low Address', with one exception: If 'High Address' is zero and 
end-of-file record is output specifying 'Low Address' as the entry 
point address. | 


External File Commands (continued) 
L Command (load memory, binary) 
L'Bias Address' 


Data in binary format are read from the logical reader device 
and stored in memory at the load address specified in the in- 
put file plus 'Bias Address'. When an end-of-file record is 
encountered control is transferred to the specified entry 

point address of zero terminates loading and the monitor remains 
in control. | 


W Command (write memory, hexadecimal ) 
W'Low Address','High Address' 


Data from ‘Low Address' through ‘High Address' are output to 
the logical punch device in a hexadecimal format compatible 
with Intel paper tape format. ‘High Address' must be equal to 
or greater than 'Low Address' with one exception: If ‘High Add- 
ress' is zero an end-of-file record is output specifying 'Low 
Address’ as the entry point address. 


R Command (read to memory, hexadecimal) 

R'Bias Address' 

Data in hexadecimal format are read from the logical reader 
device and stored in memory at the load address specified in 
the input file plus 'Bias Address'. When an end-of-file record 
is encountered control is transferred to the specified entry 
point address if it is non-zero. An entry point address of 
zero terminates loading and the monitor remains in control. 

N Command (null output) 

N 

Sixty null bytes (00H) are output to the logical punch device. 
K Command (copy files) 

Bytes are continuously read from the logical reader device and 


output to the logical punch device. This process continues un- 
til manually interrupted, I.E., by resetting the system. 


Execute and Debug Commands 
G Command (goto) 


G'Address','Breakpoint 1','Breakpoint 2' 


If 'Address' is specified, control is transferred to ‘Address’. 
If 'Address' is not specified, control is transferred to the 
address of the last encountered breakpoint, after program status 
(CPU registers and flags) is restored. 


If 'Breakpoint 1 ' or 'Breakpoint 2 ' is specified, breakpoints 
(RST 1 ) replace the bytes at corresponding addresses. These 
addresses must contain the first byte of an instruction. If break- 
points are specified, a jump instruction is stored at location. 
0008H to return control to the monitor when a breakpoint, or any 
RST 1 instruction, is excuted. At this point the monitor will 
Save the program status and restore the bytes replaced by any 
known breakpoints. Twelve bytes of the users stack are used in 
this process. The program counter in the saved program status is 
decremented, so that program execution may be resumed with the 
instruction formerly replaced by the breakpoint. Monitor com-. 
mands may then be used to display/modify memory or CPU registers, 
etc. 


When the monitor is entered normally, I.E., by other than break- 
point execution, recording of existing breakpoints is destroyed. 
Therefore, if breakpoints are set, but not executed before the 
monitor is re-entered, the contents of the bytes containing those 
breakpoints must be manually restored. 


RST 1 instructions other than known breakpoints may be used as 
pseudo-breakpoints, subject to certain restrictions. The jump 
instruction must be stored at location 0008H by previously set- 

tins a normal breakpoint. RST 1 instructions other than known.) 
breakpoints may be executed thorugh normal program execution (RST 

1 stored as part executing program) or instruction jam (interrupt). 
When such a RST 1 instruction is encountered, the monitor saves 

the program status and resets known breakpoints. However, the 
program counter in the saved program status is not decremented, so 
program execution may be resumed at the next instruction. 


X Command (register display/modify) 


X'Register' ) 

Register contents as of the last encountered breakpoint are dis- 
played. '‘'Register' may be specified as A;B,C,D,E,F (flags), H, 
L,M (H and L combined), P (program counter) or § (stack pointer). 
The registers are displayed, in the above order, beginning with 


° 


Execute and Debug Commands (continued) 


the specified 'Register'. After each register content is dis- 
played, the operator may change it by supplying the new value 

followed by a space or comma. If no new value is entered the 

old value is retained and the next register is displayed. The 
command is terminated by a carriage return, or display/modifi- 
cation of register S. 


If 'Register' is not specified, all registers are displayed with- 
out operator intervention. 


Miscellaneous Commands 
H Command (hexadecimal arithmetic) 
H'Operandl1', 'Operand2' 


The sum and difference of 'Operandl' and Operand2' are displayed 
in hexadecimal on the logical console output device. 


A Command (assign I/0 devices) 
A'Logical'='Physical' 


Physical device 'Physical' is assigned to logical device ‘Logical’. 
'Logical' may be any of the four system logical devices, I.E., con- 
sole,reader, punch, or list. Only the first character of the de- 
vice name is required. 'Physical' may be 0,1,2 or 3. The actual 
physical device assigned is determined by the installation configu- 
ration as specified in the "System Configuration Package". 


Externally Referenced Subroutines 


Several externally referenced subrountines and entry points are 
provided for use by user written software. These routines, their 
addresses relative to the beginning of the monitor (LOG) and their 
functions are listed below. 


MONTR LOC 


Normal entry point of the monitor. The I/0 configuration is in- 
ijtialized so physical device zero is assigned to each logical 
device. © 


CI LOC+3 


Console input. One character is read from the logical console 
input device and returned in register A. All registers other 
than A and F are preserved. 


Externally Referenced Subroutines (continued) 
RI LOC+6 


Reader input. One byte is read from the logical reader device 
and returned in register A. All registers other than A and F 
are preserved. If no byte is available from the reader, the 
carry flag is set upon return. 


CO LOC+9 


Console output. The byte in register C is output to the logi- 
cal console output device. All resisters other than A and F 
are preserved. 


PO LOC+OCH 


Punch output. The byte in register C is output to the logical 
punch device. All registers other than A and F are preserved. 


LO LOC+OFH 


List output. The byte in register C is output to the logical 
list device. All registers other than A and F are preserved. 


CSTS LOC+12H 


Console status. The logical console input device is checked 
for input availability. Register A is set to zero and the zero 
flag set true if no input is available. Register A is set non- 
zero and the zero flag set false if a character is available. 
All registers other than A and F are preserved. 


IOCHK LOC+15H 
The current setting of IOBYT is returned in register A. IOBYT 
is the byte of RAM used to record the current logical device/ 


physical device assignments. 


Bits 0,1 Record the physical device currently assigned to the 
logical console device. 


Bits 2,3 Record the physical device currently assigned to the 
logical reader device. 


Bits 4,5 Record the physical device currently assigned to the 
logical punch device. 


Bits 6.7 Record the physical device currently assigned to the 
logical list device. | 


Externally Referenced Subroutines (continued) 


All registers other A and F are preserved. 
IOSET LOC+18H 


The contents of register C are stored in IOBYT, thus altering 
the logical/physical device assignments. All registers are 
preserved.. 


MEMCK LOC+IBH 


The upper limit of RAM available to user programs is returned 
in registers B (most significant) and A (least significant). 
The address returned is that of the first byte not available 

to the user. All registers other than A,B and F are preserved. 


STRNG LOC+1EH 


The string of characters pointed to by registers H,L is oytput 
to the logical console output device. The character strifig is 
terminated before a null character, or after A character with 
bit 7 set. Registers B,D,E are preserved. | 


REENT LOC+21H 


Alternate entry point to the monitor. The current I/0 configura- 
tion is not altered when the monitor is entered at this point. 


system Configuration Package 


The system configuration package is used to "Tailor" the monitor 
to a particular system hardware/software configuration. The 
package consists of a table establishing the I/0 configuration, 
several entry points for establishing certain memory addresses, 
and driver routines for system I/0 devices. The table and entry 
points, their addresses relative to the beginning of the package 
(SCP) and their functions are listed below. 


IOTAB SCP 


This table consists of six sub-tables, each consisting of four 
entries of two bytes each. Each sub-table entry is the entry 
point address of a driver routine for a particular physical 
device. Each sub-table lists the driver routines for the four 
physical devices that may be assigned to a locical device. Sub- 
tables are included for console status, console input, console 
output, reader input, punch output, and list output. | 


System Configuration Package (continued) 
ADSCS);""SCP+30H 


Subroutine to set registers D,E to the address of the top of 
the monitor scratchpad area of RAM. This subroutine is called 
without the use of the stack. 


ADSCR SCP+33H 


Subroutine to set registers H,L to the address of the top of the 
monitor scratchpad area of RAM. This subroutine is called in the 
normal way, I.E. by a call instruction. The monitor requires 

64 bytes of RAM for scratchpad. Of these 64 bytes, the top four 
are unused by the monitor itself, and may be used to store I[OBYT 
and up to three other bytes such as those associated with a CRT 
output device. 


ADIOB SCP+36H 


Subroutine to set registers H,L to the address of IOBYT, the byte 
of RAM where the current I/0 configuration is recorded. 


ADUST SCP+39H 


Subroutine to set registers H,L to the address of the users stack. 
This is a default value used only until replaced by the operator 

(X command) or by execution of a breakpoint. It is expected that 
user routines will initialize the stack pointer when they are first 
entered. 


CSZAFi 
CObGra 
C3EGFS 
C3DIFa 
C3ESFZ 
G3EAFS 
C3DBFS 
C3QEF 1 
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2lBBse 
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SYSTEM CONFIGURATION INTERFACE 


Eau OF680H 
EQU SCP 

EQU SCP+48 
EQU SGP+51 
EQU SCP+54 
Bau SGP+57 


ASCII CHARACTERS 


EQu @DH 
EQU @AH 
ORG SF @SGH 


EXTERNALLY REFERENCED SUBROUTINE 
JUMP TABLE | 


J MP BEGIN 
JMP Om § 

JMP RI 

JMP GO 

a MP PO 

d MP LO 

J MP GSTS 

wd MP IOCHK 

w kiP IOSET 

J MP MEMGK 

J MP OTRNG 

My I Ca B 

LAt Hs @ 

ORG $-2 

MV I Col 

LAI Ds St6 

J MP ADSCS 
ACHG : 
MV I Bs ENDX-EXIT=i 
LAI Ds ENDX-1 
DCX D | 
LDAX D 

DCX H 

MOV Ms A 

DGR B 
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ERROR RETURN 


INPUT AND EXECUTE NEXT COMMAND 
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Ds EXIT-ENDX~7 
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TBL:- 


DB CR» LFs* MONITOR Vie's *@° 
D2 LFsa*** OR 8OH 
COMMAND JUMP TABLE 
OW ASSIGN 

DW BIN 

DW LER 

DW DISP 

DW LER 

DW FILL 

DW GOTO 

DW HEXN 

DW LER 

DW LER 

DW KOPY 

Di LOAD 

DW MOVE 

DW NULL 

OW LER 

DW LER 

DW LER 

OW READ 

DW SUBS 

OW LER 

DW LER 

DW LER 

DY WRITE 

DW x 


UTILITY SUBROUTINES 
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' F2BA 
F2BB 
F2BC 
 F2BD 
F2BE 
FeBF 


F268 
F263 
F2C6 
F267 
F268 
F209 
F2CA 
F2CD 
F2Do 
F2D2 
F2D5 
F2D6 
F2D7 
F2D8 
-F2b9 
F2DA 
F2DB 
F2DC 
F2DD 
F2DE 
F2DF 
F2E@ 
F2E1 
F2E2 
F2E3 
F2E4 
F2E7 


F2E9. 


BE7S 


BC 
C2E9F2 
GEFF 
DS 


AS2: 


AS33 


EREXT 8 


Bg 3s 


B23 


CRLF 
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V2EA 
r2EB 
F2EE 
l2re 
Fare 
F2F4 
vara 
varé& 


Bere ¢ 


Sra 


732A 
7328 
T92E 
F331 
PO32 
F333 
7334 
7336 
#339 


F3GG 
FOSD 


F340 


oY 


CDAAaF I - 


GESC 
CDESF@ 
4b 


a 5? 
' GDESFS 


1p 
Ge@FAF2 
RY s) 
OUDES5SFS 
ne 
7D 
1344 
Ae 


: | SDCF2 


GDESFO 
ap 


8 GDESF? 


ag 
GIESF@ 


UDS2F) 
i | 
El 
OD46F1 
DIOF 1 
SDCFFS 
7& 
CD9S5FiIi 
GCUS6FI 
SF 

DB 

TD 
Z60F 
GeelF3 
G321F3 


B33 


PHL 8 


DI@Gs 


DIls 


FILL: 


MOV baG 
CALL LEADS 
MV Gs 3GH 
CALL PO 
MOY GCaoE 
CALL PHL 
MOV AeH 
ADD Le 
MOV De A 
MOV Oo M 
INX Ho 
MOV Aa D 
ADD (3 
MOV De & 
CALL PO 
DCR iB 
ANZ B3 
MOV GaD 
CALL PO 
POP D 
MOV Re Le 
QRA oe 
RZ 

JP Bl 
CALL PO 
MOV Cal 
CALL PO 
MOV CoH 
MP PO 
DISPLAY 

GALL, EAPR 
POP D 
POP Hi 
CALL RLF 
CALL LADR 
CALL BLK 
MOV AeM 
CALL LBYTE 
CALL HILO 
GMC 

RNC 

MOV Ael 
ANT @FH 
JNZ DI4 
wi MP DIZ 


FILL COMMAND 


INR C 
CALL EXPR 
POP 3 
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F341 Di POP D 
F342 El POP H 
F343 71 FIGs MOV Me 
F344 CD86F! CALL HILO 
F347. D243F3 JNC FId 
F34A B7 ORA A 
F34B C9 RET 

3 GOTO COMMAND 
F34C El GOTO: POP H 
F34D CDE2F1 | CALL PCHK 
F358 DA98F3 JC Go3 
F353 CA72F3 JZ GOs 
F356 CD7EFI CALL EXF 
F359 Dl POP D 
F35A 211386 LXI Hs» PLOCG 
F35D 39 DAD SP 
F35E 72 MOV Ms D 
F35F 2B DCX H 
F369 73 MOV Ms E 
F361 78 MOV A»B 
F362 FEQD CPI CR 
F364 CA98F3 JZ GO3 
F367 3EC3 MVI A» (JMP B) 
F369 3288989 STA 8 = 
F36C 2I1FIFI LXI Hs RESTRT 
F36F 223962 SHLD 9 
F372 1662 GOS: MVI Ds2 
F374 211466 LXI Hs TLOC 
F377 39 : DAD SP 
F378 ES GOls PUSH H 
F379 CDS5@F1 CALL EXPRI 
F37C 58 | MOV EsB 
F37D Cl POP B 
F37E El POP H 
F37F 78 MOV A»sB 
F388 Bl ORA C 
F361 CASEF3 JZ GO2 
F384 71 MOV MsC 
F385 23 INX H 
F386 76 MOV MsB 
F387 23 INX H 
F388 OA LDAX B 
F389 77 MOV MsA 
F38A 23 INX H | | 
F36B 3ECF MV I &» CRST 1). 
F38D 82 — STAX B | 
F38E 7B GO2: MOV AsE 
F38F FEOD CPI CR 
F391 CA98F3 JZ GO3 
F394 15 DCR D 
F395 C278F3 JINZ GOl 


Zi 


ek 
3 AS 
Raye es 
PCy ow) 
GAS 
TOAaAy 
Ree rs Va\ 
oad 
TIBE 
RCe= my 
Pobe 
FOB 
Tobe, 
TOBE 
F3aBG 
FABF 
OBL 
“SBE 


73BC 
73BF 
730K 


ame Ogg om, 
' «ay € 
i ol ter? 


Fr3aGé 
FaGc9a 
FSGCA 
w3O0D 
T3CE 
F3De 
F3D3 
F3DS 
7SD& 


COU46F4 
218888 


, 3 
ED 


WDS5eF 1 
POR 
zl 
UD46F 1 
bo 
19 


GDOOFL- 


GDOFF? 
bo 
7D 
23 
SF 
FU 
IA 
57 
GDSOF Ii 
37 
ae 


GDEGFA 
Ak 

ODESF® 
GIBCFS3 


GDSOFI 
(st 
GDEOFO 
DS 
FESS 
OGADFF3 
F E78 
GeGCAFS 
GDOLF4A 
DS - 


2 132 


8 


vets re) 
at ed 
4 daveb 


UDEGFSG 


faa D& 


oF 


GDYOIFA 
P ps 


GO33 


HEXN: 


ae 


KOPYs 


fen 


LOAD: 


Lis 


L2s 


CALL 
LXI 
DAD 
PCHL 


HEXADECIMAL COMMAND 


CALL 
POP 
POP 
CALL 
PUSH 
DAD 
CALL 
CALL 
POP 
MOV 


CRLF 


H, @B08H 


SP 


EXPR 
D 

H 
CRLF 
H 

D 
LADR 
BLE 


COMMAND 
Ri 
CoA 
PO 
KOPY 

COMMAND 


EXPRI 


Z2 


F3E& 
F3E9 
FSEA 
F3EB 
FOES 
F3EF 
FOFG 
FSF I 
FOF2 
FOFS 
FOFS 
FOF7 
FOFA 
FOFB 
FSFC 
FPOFF 


 F4g@ 


F401 
F4G4 
F405 
F406 
F489 
F4AGA 
F468 


F40G 
F48D 
F410 
F4L1 
F4l2 
F413 
F414 
Fals 
F416 
F4l9 
F4ic 
F41D 


FALE 
F420 


F423 
F426 
F427 
F42A 
F428 


F42D° 


G9 


D8 


G63C6 
C3A6F1 


CDSOF I 


El 


L3s 


LHL? 


y) 


MOVES: 


es 


NULL: 


we 


READ 3: 


RED@: 


HsA 


COMMAND 


G 
EXPR 


COMMAND 


Bs66 
LEAD 


COMMAND 
EXPRI1 
H 
RI 


7TFH 


i 
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Faer 
F432 
F4a3 
F434 
F437 
F43a 
F433 
FASE, 
F4aSF 
Pade 
Paas 
F444 
F4a7 
PAG, 
bP dg das 
Fad 
| Paap 
r4a5e 
Pasa 
PAS &, 
P45? 
PASE 
F459 
F456 
F450 
Fae 
PAG I 


ed oe" : 
Fa rs) & is 


F463 
sh G 4h 
AGS 
PAGS 
PAGO 
FAGA 
Faols 
F466 
PAON 
FATS 
F447 1 
Fave 
Fag 3 
P47 A 
Fed 7 
FaT6 
F479 
F476 
FATE 
Fagi 
F464 


F465 | 


F436 
F437 


Page 


GCe2TF4 
57 
Lo 
GOD65F4 
CASIFA 
SF 
CD65F4 
4% 
CD6E5SFA 
4 


GOD65F4 
i 
GALTFS4 
37 
US 
OD6S5F4 
7? 
GD65F4 


9 
BZDT6F4 
37 

Sy 

yy 

‘a’? 

ay 
ODT6F4 
3l 

4aF 

82 

57 

79 

9 
GCDEOF SB 
DASSF4 
E67F 
CDDGOF 1 


DASBSF4 


G9 


REDI : 


RED2: 


BYTES 


RNBBL $s 


RNBER 3 
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F489 
F466 
F48F 


F496 - 


F491 
F492 
FASS 
F497 
F49A 
FAQD 
FASE 
F49F 
F4A2 


. F4Aa3 


F4A6 
F4A7 
F4AS 
F4A9 
FAAA 
F4AC 
F4AD 
F4AE 


F4B1 
F4B4 
F4BT7 
F433 
F4B9 
F4BA 
F4BB 
FABE 
F4c 1 
Fac3 
F466 
F407 
F4C8 
F4C0B 
FACE 
F4D9 
F4D3 
F4D4 
F4D5 
FAD8 
F4DB 
FA4DC 
F4DD 
F4DE 
FADF 


CDS@FI 
CDESF1 
El 


CDICFS 


ee 


SUBS: 


oUG3 


SU1s: 


e 
# 


WRITE: 


WRITG: 


WO 3 


SUBSTITUTE COMMAND 


EXPRI 
P26 
H 


HH 
sUg 


WRITE COMMAND 


EXPR 
GRLF 


25 


AF 


G& 
G3EGFA 
7¢ 
CDICFS 


WRIG8 


WRI38 


PADRs 


PBYTEs: 


26 


F535 


F536 


FSSA 


F33D 
F346 
F543 
F345 
F548 
F549 
F548 
FS4D 
FS4E 
FS4F 
F552 
F551 
F552 
F553 
F354 
F357 
FSSA 
FS5B 
F556 
FS5D 
FSSE 
F560 
F561 
F362 
F363 
F364 
F365 
F566 
F569 
FS6A 
FS6D 
FS6E 
FS6F 
F572 
FS73 
F375 
F578 
F573 
FS7C 
FS7D 
F589 
-FS81 
FS8e 
F585 
F586 
F587 


F568 © 


CDESFO 
BEGA 
C3ESF@ 


CDeFFi 


Se 


X83 


XO 3 


X13 
X28 


X3 3 


GALL 
MV I 
JMP 


PO 
CsoLF 
PO 


REGISTER COMMAND 


TI 


Hs» ACTBL 


vad 


F569 
F56A 
F583 
F5&o 
FS58D 
F592 
F594 
FS92 
FOS 
P34 
F395 
F596 
F597 
F59%¢ 
F599 
F59B 
| F59C 
F59F 
F5Aa2 
F5A5 
F5A6 
F5A7 
F5AS 
FSA9 
FSAA 
F5AaD 
F SAF 


F5Be 7 


F533 
F334 
FSBS 
F536 
F538 
F5B9 
FSBA 
F533 
FS5BC 
F538D 
FSO 
F501 
F5C4 
F5C5 
F5C6 
F509 
FSCC 
FSCF 


F5D2 4 


F3D5 
FSDS& 
FSDs 
FSDE 


7D 
l2 
oi 
WS 
CAGY3FS 
13 


C35AF5 
CD46F 1 
CDCFF@ 


Té& 


481201 


X43 


X53 


XE 
X73 


ACTBL?: 


AaL 


°H' , 


28 


ALOG+2 » 
BLOG+235 


GCLOC+2; 


DLOG+2~s 
ELOG+2s 
FLOG+e2~s 
HLOG+2~s 


Gut Pet feo Fd FeO Geo got 


FSE1 
FSE4 
FSE7 
FSEA 
FSED 


6866 


4011361 
4D1202 
3413562 
538982 
FF 


"Ls 
a ha 
pe, 
°S°s 
ad | 


29 


LLOC+2» 


HLOC+2, 


PLOC+2. 
SLOC+2.4 


0 F3 & o= 


Fodd 


Foow 
F6a2 
F604 
F606 


ADF6 
TFF6 
TFF6 
1FF6 


FOZA 6&5 


F60C 
FOWE 


F6élé 
F6l2 
F614 
F616 


O7F6 
BT7F6 
D4F6 
59F6 


eo we Yo we 


se we 


IOTABs 


Sa 


CSTAB: 


Yes 


COTABS: 


va we 


wa we 


SYSTEM CONFIGURATION PACKAGE 


ORG OF 600H 


LOGICAL DEVICE/DEVICE DRIVER TABLES 
EACH 4 ENTRY TABLE LISTS THE ADDRESSES 
OF THE DRIVER ROUTINES TO BE USED FOR 


THE PHYSICAL DEVICES WHICH MAY ASSIGNED 
TO THAT LOGICAL DEVICE. 


CONSOLE STATUS 


RETURN WITH REGISTER A = @ IF NO 
CONSOLE CHARACTER AVAILABLE. 


DW  =—s-« TTST 1) 
DW KYST 31 
DW ~~ «KYST 32 
DW KYST 33 


CONSOLE INPUT 


RETURN CONSOLE INPUT CHARACTER 
IN REGISTER Ae 


DW TTI 36 
DW KYBD 3 | 
DW KYBD $a 
DW KYBD 33 


CONSOLE OQUTPUT 


OUTPUT BYTE IN REGISTER C 
TO CONSOLE OUTPUT DEVICE. | 


DW TTO 32 
DW TTO 31 
Dw THRM 32 
DW CRT 33 


READER INPUT 


RETURN READER INPUT BYTE IN 
REGISTER A, CARRY OFF. SET 
CARRY IF NO BYTE AVAILABLE. 


F618 
F6l1A 
F61C 
F6LE 


F620 
F622 
F624 
F626 


F628 
F62A 
F62C 
F6eE 


F630 C33DF6 


C2Fré6é 
S7F6 
G6F6 


FOBS 


B7F6 


DFF6 — 


S9F6 
7339 


B7F6 
S9OF6 


D4F6 
B7F6 


RITAB? 


ee 


fea tec 


POTAB 3 


tee 


se 


LOTAB: 


ve 


we tee %e We 


we 


NOTE? 


Ye we we ve 


wee te 


ADSCS: 


Yew we be 


feo we Wo 


a 


DW TTR 38 
DW RDR | 
DW KYBD $2 
DW BBSFOH 


33 DISK READ 


PUNCH OUTPUT 


OUTPUT BYTE IN REGISTER C 


TO PUNCH DEVICE. 


DW TTO 38 
DW PUNCH 31 
DW CRT 32 
DW Q@B973H 33 DISK WRITE 


LISTING OUTPUT 


OUTPUT BYTE IN REGISTER C 
TO LISTING DEVICE. 


DW TTO 32 
DW CRT $1 
DW THRM 32 
DW TTO 33 


SPECIAL SUBROUTINE TO LOCATE MONITOR 
SCRATCH RAM 


THE ADDRESS OF THE TOP OF THE SCRATCH 
RAM AREA USED BY THE MONITOR IS RETURNED 
IN REGISTERS DosE- 


THIS SUBROUTINE IS NOT CALLED IN THE 


USUAL WAY: INSTEADs, THE RETURN ADDRESS 

IS PLACED IN REGISTERS DsE AND THE 
SUBROUTINE IS ENTERED BY A JUMP INSTRUCTION. 
RETURN IS DONE BY PLACING THE RETURN 
ADDRESS IN Hs,L AND EXECUTING A PCHL INST. 


JMP ADSe 


SUBROUTINE TO LOCATE MONITOR SCRATCH 
RAM : 


THE ADDRESS OF THE TOP OF THE 64 BYTES 
OF RAM TO BE USED BY THE MONITOR FOR 
SCRATCHPAD IS RETURNED IN REGISTERS 

Hs Le 


oF 


F633 


r636 


C34FF6 


UIS4FF6 


a2lgddl 
U9 


2ldaddd 


GASBFS6 
2B 
EB 
EY 


D5 
L1S6F6 
C33DF6 
ES 
Di 
U9 


ADSGR: 


> 


tsa Ye Wwe we we Bs 


ADIO3: 


%s we Ps Se 


%s Ss 


ADUST: 


ADS2: 
ADS3s 


JMP ADSI 


SUBROUTINE TO SET ADDRESS 
OF IOBYT 


THE ADDRESS OF THE BYTE USED TO 
RECORD THE GURRENT PHYSICAL/LOGICAL 
DEVICE ASSIGNMENTS IS RETURNED IN 
REGISTERS HsLe 3 | 


JMP ADSI 


SUBROUTINE TO SET THE USER STAGK 
ADDRESS-» 


THE ADDRESS TO BE USED AS THE 
DEFAULT VALUE OF THE USER STACK 
ADDRESS IS 


LAt H, @19@H 
RET 

LAL Hy» 8 
INR H 

MOV Aa M 
GMA : 

DI 

MOV MsA 
CMP M 

CMA 

Op = 
MOV Ms A 
JZ ADS3- 
DGX H 
ACHG 

PCHL 

PUSH D 

LAL Ds $t+6 
JMP ADS2 
ACHG 

PoP D 

RET 


PHYSICAL DEVICE DRIVER ROUTINES 


REQUIREMENTS 
MAINTAIN CONTENTS OF ALL 
REGISTERS EXCEPT A AND Fa 
EXIT BY RETURN INST. 
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RETURNED IN REGISTERS Hele 


F659 
F65A 
F653 
F65C 
F65D 
F660 
F661] 
F662 
F663 


F666 
F663 
F66A 
F66D 
FO6F 
F671 
F673 
F676 
F673 
F673 
F67D 
F67E 


FO7F 
F681 
F683 
F685 
F686 


F687 
F688 
F65B 
F68D 
F68F 
F692 
F693 
F694 
F695 
F698 
F699 
F69A 


D27DF6 
E6DF 
B7 

C9 


tee 


GRTs 


we 


KYBDs 


KBI 3: 


we 


' KYSTs 


we 


RDR:s 


RD 3 


VIDEO DRIVER 


AaG 


A SCHECK FOR NULL 


@F794H. 


KEYBOARD DRIVER 


61H SLOWER CASE A 
SLOWER CASE Z +1 


sDELET ONE BIT 


KEYBOARD STATUS DRIVER 


IN 

AN f 
sul 
SBB 
RET 


@ 
1 
l 
A 


READER DRIVER 


H 
Hs B 
4 

| 
RD2 
H 
As H 
L 
RD 


H 


33 


F693 
F69D 
F6SE 
F69F 


FOAW 
F6Ae 
F 6AG 
F6A6 
F6AT 


F6AG 
F6A9 
F5AB 
F6AD 
F6AF 
F6B2 
F6B4 
F686 


oe, 


Son7 
r6p9 
POobs 
F6RE 


von 
* 6OBF 
coy : e 


F6C 1 


Fec2 
F6C4 
FEC 
F6C8 


FOGA i 


FOGC 
F6CE 
F6D1 
F6D3 


wi 
£659 
C2sT7TF6 


E601 
C2GAFS5 
DBdI 
G9 


RD2 3: 


‘ws 


TTST:3 


we 


TTI 


TTIZ1: 


fen 


TTC s 


TTR s 


TELETYPE STATUS DRIVER’ 


iN 

ANZ 
sul 
5BB 
RET 


TELETYPE INPUT DRIVER 


TELETYPE OUTPUT DRIVER 


IN 
ANI 
JNZ 
MOV 
OUT 
RET 


TELETYPE READER DRIVER 


MV I 


OUT 


@ 
i 
i 
A 


0 
8 


OH 


TTO © 


A 
b 


A 


A 


2G 


al 


2@ 
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THERMAL PRINTER DRIVER 


we 


F6D4 DBV2 THRM: IN 4 
F6D6 E680 ANI 6@H 
F6D8S C2D4F6 JNZ THRM 
F6D8B 79 MOV AeG 
F6DC D383 OUT 3 
F6DE C9 RET 

3 PUNCH DRIVER 
F6DF DBI4 PUNCHs IN. 4 
F6EL E68 ANI 88H 
F6E3 C2DFF6  JNZ PUNCH 
F6E6 79 MOV Asal 
F6E7 D385 OUT 3 
F6E9 C9 RET 
038d END 


F706 


ECBd 


BC44 
BCA6 


Be@c 
BOBA 


OOBD 


F706 


F708 ES 
F761 214430 


es 


‘ee 


wea Ys Ss Ys %: Ge Be Bs “wo 


Ss Ba 


LOC 


VDPTR 


VDHLD 


Se 


FF 
LF 


GR 


‘es 


VOTTY3 


eeu 


VIDEO BOARD DRIVER 


THIS SUBROUTINE FACILITATES THE USE 
OF THE SOLID STATE MUSIC VBI BOARD 
AND A VIDEO DISPLAY DEVICE AS A 
GONSOLE OUTPUT DEVICE. 

ASCII CHARACTERS PRESENTED TO THE 
SUSROUTINE IN THE G REGISTER ARE 
DISPLAYED ON THE SCREEN. CERTAIN 
CHARACTERS», LISTED BELOWs RECEIVE 
SPECIAL TREATMENT.» ALL REGISTERS 
ARE PRESERVED BY THIS SUBROUTINE. 


LOC IS THE BEGINNING ADDRESS OF THE 
SUBROUTINE. IT MAY BE IN RAM OR ROM. 


EQU OF 700H 
VID 1S THE BEGINNING ADDRESS ASSIGNED 
TO ‘THE DISPLAY RAM LOCATED ON THE VBI 
BOARD. 

EQU @ECO@H 38B000\ 

THREE BYTES OF RAM ARE REQUIRED FOR 
HOUSEKEEPINGe THESE BYTES MUST BE 

IN AN AREA UNUSED BY OTHER PROGRAMS. 


EU @BC44H sCURSOR POINTER 
EQU VDPTR+2 sCHARACTER HOLD 


NON-DISPLAYABLE CHARACTERS 


EQu @CH SFORM FEED 
SCLEAR SCREEN» HOME CURSOR 


Eau GAH SLINE FEED . 


3DOWN ONE LINEs CLEAR LINE 
EQU GDH SCARRIAGE RETURN 
$MOVE CURSOR TO LEFT MARGIN 


NORMAL ENTRY POINT 


ORG Loc 
PUSH H | 3SAVE HL 
LXI H»VDPTR SADDR OF CURSOR POINTER 


ALTERNATE ENTRY POINT 
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F764 
F705 
F706 
F707 
F728 
F709 
' F768 
F7@D 
F70E 
F7OF 
F718 
F711 


F712 
F713 
F715 
F718 
F71A 
F71iD 
F71F 


F722 
F723 


F726 


F727 
F728 
F72A 
F72D 


' F730 


F733 


79 
FEOC 
CA4BFT7 
FEOD 
CAS9F7 
FEOA 
CA66F7 


71 
Didids 


09 . 


7C 
FEFO 
C236F7 
21C@EF 
CD7FF7 
C330F7 


we we Se We Go Ge He We Ye 


ENT Rs 


ALTVD: 


we 


CRRT: 


we 


CRADJ: 


ea 


we we 


THIS ENTRY POINT MAY BE USED IF 
THE CURSOR POINTER AND CHARACTER 
HOLD ARE AT LOCATIONS OTHER THAN 
THOSE SPECIFIED ON THIS LISTING. 
THE USER MUST SUPPLY rpm aa 

ENTRY CODE AS FOLLOWS: 


PUS H H SSAVE HL | 
- LXI HsPNTR #3ADDR OF CURSOR POINTER 
J MP ALTVD SJOIN THIS CODE 
PUSH D 3SAVE DE 

PUSH B 3SSAVE BC 

MOV EsoM SLPTR 

INX H 3 

MOV Aa M 3HPTR 

ANT 3 3 CONVERT TO VIDEO 
ADI VID SHR 8 3RAM ADDRESS 

MOV Deh 3 

INX H | 3 

MOV BsM SCHAR UNDER CURSOR 
XCHG SPNTR TO HL © 

MOV Ms B SRESTORE PREV CHAR 
IDENTIFY INPUT CHAR 

MOV AsG 3NEW GHAR 

OPI FF 5 | 

JZ VIDFF 3FORM FEED 

CGPI OR 3 

JZ VIDGR SCARRIAGE RETURN 
CPI LF 3 

JZ VIDLF sLINE FEED 

MOV Ms & 3 

LxI Bol 


ADJUST CURSOR POINTER 
DAD B 3 


CHECK FOR OVERFLOW 


e 


MOV AsH 3 

CPI CVID+1G24) SHR 8 3 
JNZ VIDRT 3 

LXI HsVID+960 5 

GALL ROLLG 3 

JMP VIDRI F 


COMMON EXIT CODE 
NORMALIZE CURSOR POINTER 
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F736 
F738 
F739 
F7SB 
F730 
F73D 
FISF 
F740 
F741 
F742 


F7AS | 


F744 


F745 
F746 
FIAT 
F746 
F749 
F74A 


F759 
FT7SA 
F73G 
F7SD 


F769 
F761 
F764 


‘cam Sb eB ” 


21 BBEC 


C336F7 


VIDRT: 


VIDRI? 


Yes 


Bo te Ge 


VIDFF: 


VIDFCs: 


fs we ee 


VIDCRs: 


we we 


8s @ 


VIDLF s 


MV I Hs (VID496@) SHR 8 3 

mOoV Aol, 3 

OR? 8COH 3 

MOV Le A 3 

MOV AsM 3CHAR UNDER CURSOR 
MV I Ms 7FH 3 CURSOR 

XCHG 3PNTR TO DE 

MOV MeA 3CHAR UNDER CURSOR 
DGX H 3 | 
MOV Ms D 3HPTR 

DCX H 3 

MOV MoE ILPTR 

RESTORE REGISTERSs EXIT 

POP B 3 

POP D 3 

POP Hi 3 

MOY Ae 3 

ORA A 

RET ; 


PROCESS FORM FEED 
FILL SCREEN WITH SPACES s 
MOVE CURSOR TO TOP LEFT 


lo T He VID 3 
PUSH rH ’ 
MV I Ms* ° F 
INX Fs | 3 
MOV Aa Fi 
CPI CVID+1024) SHR & 5 
JG VIDFG 3 
POP Hi 3 


PROCESS GARRIAGE RETURN 
MOVE CURSOR TO BEGINNING 


OF LINE 
MOV Aol 3 
ANI ZG@H 2 
MOV Lah 3 
JMP VIDRT 3 


PROCESS LINE FEED ; 
MOVE CURSOR DOWN ONE LINE, 
FILL NEW LINE WITH SPACES 


PUSH D 3 
LXI Ds 64. 3 
DAD D 3 
MOV Bel 3 
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F766 
F768 
F769 


F76C 
F76E 
F770 


F773 
F776 
F777 
F779 
F77A 
F770 


FU77F 
F78@ 
F781 
F754 
F787 
F788 
F789 
F763 
F78C 
F78D 
F78E 
F792 
F793 


F794 
F795 


FEFO 
D1 
C236F7 


DSBFF 
E681 
CA6CF7 


CD7FFT 
7D 
F6C@ 
6F 
26EF 
C336F7 


DS 

ES 
1139EC 
2148EC 
1E 

12 
3620 
13 

23 

7C 
FEF@ 
C287F7 
EI 


D1 
C9 


we Be Be Yo 


VDLFa2 3 


wea 


ROLLG: 


ROLL1I 


ROLL2 


ee 


to Wwe 


CPI (VID + 1624) SHR & 3 
POP Dt ; | 
JNZ VIDRT 3 


THE FOLLOWING INSTRUCTION 


(MARKED XXXX) MAY BE REMOVED 


IF SENSE SWITCHES ARE NOT 
TO BE USED. 


WAIT UNTIL SENSE SWITCH 1 IS ON 
BEFORE ROLLING UP ONE LINEs 


IN OF FH 3 XXXX 
ANI 1 3 XXXX 
JZ VDLF2 sXXXX 


ROLL THE WHOLE DISPLAY UP ONE 
LINE. | 


CALL ROLLG 3 
MOV Asl F) 
ORI @C@H 3 
MOV LeA 8 
MVI Hs CVID+960) SHR & 3 
J MP  VIDRT 3 


ROLL SUBROUTINE 


PUSH D 3 
PUSH H 3 
LXlI DeVID 3 
LXI Hs VID+64 3 
MOV AsM 3 
STAX D 

MUI Ms 20H 3 
INX D ; 
INX H ; 
MOV Asi 3 
CPI (VID+1624) SHR 8 3 
JNZ ROLLI ; 
POP H 3 
POP D ; 
RET 3 


GRAPHICS INTERFACE SUBROUTINES 


THESE SUBROUTINES FACILITATE THE 
USE OF THE SOLID STATE MUSIC VBI 
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F796 
F799 
F79A 


F796 
F79E 
F7AG 
F7A2 
F7A3 
F7A4 


CDBOF7 
Al 
G9 


CDOBOF?7 
E6OBF 
F688 
Bl 

A 
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tea 


%o tse Se Be % Se te 


tee te Ss Be Bo Bs we Ws We we 


Se we es 


‘tee Se tee 


ie tg ‘ee ee 


ee 


‘se we &e Se 


WHITESs 


BOARD AND A VIDEO DISPLAY DEVICE 
AS A GRAPHICS DISPLAY DEVICE. 


THESE SUBROUTINES TREAT THE DISPLAY 
SCREEN AS A MATRIX OF DOTSs 48 DOTS 
HIGH BY 128 DOTS WIDE. EACH DOT IS 
SPECIFIED IN TERMS OF ITS VERTICAL 
COORDINATE(@-47) AND ITS HORIZONTAL 
COORDINATEC@-127)- DOT 8.8 IS AT 
tHE LOWER LEFT CORNER OF THE SCREEN. 


THE SUBROUTINES HAVE SIMILIAR 
INTERFACES WITH THEIR CALLING : 
PROGRAMS. REGISTER B IS PRESERVED. 


ENTRY CONDITIONS: . 


H # VERTICAL COORDINATE 

L, = HORIZONTAL COORDINATE 
EXIT CONDITIONS 

&® @ DIFFERS BY SUBR 

B = PRESERVED 

G # BIT MASK FOR SPEGIFIED DOT 

DE= MEMORY ADDRESS OF DOT 

Me VERTICAL COORDINATE 

L = HORIZONTAL COORDINATE 


OUT INE 


Ni CONVERTEDCIF NECESSARY) 
Mo DULO 48 AND 128 RESPECTIVELY. 


THE CHECK SUBROUTINE SETS THE ZERO 
FLAG TO INDICATE WHETHER THE SPECIFIED 
DOT IS WHITE OR BLACKe IF THE BOT 

iS CURRENTLY WHITE THE ZERO FLAG [5S 
SET ONs iF THE DOT IS BLACK THE FLAG 
IS SET OFFe THE A REGISTER CONTAINS 
ZERO IF THE DOT IS WHITEs THE BIT 

MASK IF IT IS BLACK. 


CALL GNVRT s 
ANA GC 3 
RET 3 


THE WHITE SUBROUTINE SETS THE 
SPECIFIE D DOT WHITE. REGISTER 
A GONTAINS THE NEW GONTENTS OF 
THE MEMORY LOCATION. 


GNVRT 3 CONVERT 
QBFH - SCLEAR UNUSED BIT 


OH 8SET GRAPHICS BIT 
G SET THIS DOT 

G SGLEAR THIS DOT 

D SUPDATE BYTE 
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F7AS C9 | RET 8 


THE BLACK SUBROUTINE SETS THE 


3 
3 SPECIFIED DOT BLACK. REGISTER 
3 A CONTAINS THE NEW CONTENTS OF 
2 THE MEMORY LOCATION. 
F7A6 CDBOF7 BLACKs CALL CNVRT 3 CONVERT 
F7A9 E6BF ANI @BFH 3CLEAR UNUSED BIT 
F7AB F680 ORI 80H 3SET GRAPHICS BIT 
F7AD Bl ORA GC: 3SET THIS DOT | 
F7AE 12 STAX D SUPDATE BYTE 
F7AF C9 RET : 3 


3 THE CNVRT SUBROUTINE PERFORMS 

; THE COORDINATE TO ADDRESS - 

3 BIT MASK CONVERSION. REGISTER 
sl A CONTAINS THE CURRENT CONTENTS 
3 OF THE MEMORY LOCATION. | 


F7B8 C5 CNVRT: PUSH Bo  § 
3 NORMALIZE THE COORDINATES 
F7B1 7D MOV AsL 3 
F7B2 E67F | ANI TFH ; 
F7B4 6F 7 MOV LeA 3 
F7B5 7C MOV AsH 3 
F7B6 D63d Dis Sul 48 3 
F7B8 F2B6F7 JP Di ; 
F7BB C636 D2: _ ADI 48 3 
F7BD FABBF7 © JM D2 ; 
F7CQ 67. MOV HsA 3 
F761 ES PUSH H ; 
; CONVERT COORDINATES TO ADDRESS 
3 IN DE 
F7C2 44 MOV BoH ; 
F7C3 4D | MOV CoL 3 
F7C4 SC MOV E»H 3 
F7CS 1666 MVI Ds» @ ; 
F7C7 218128¢ : LXI Ho | 3 
F7CA 19 DAD D F 
F7CB 29 DAD H 3 
F7CG 29 DAD H ; 
F7CD 19 DAD D 3 
F7CE 29 DAD H 3 
F7CF 29 DAD H 3 
F7D@ 19 DAD D ; 
F7D1 54 MOV DoH ; 
F7D2 7D MOV AsL ; 
F7D3 E6C@ ANI @COH 3 


F7DS 
F7D6 
F7D7 


F7O8 3 


PT D9 
F7DA 
P7 DB 
FIDO 
®7DD 
FT DF 
F7EO 
FU7EL 
F7ES 
F7EG 
F7 ES 
F7E6 
F7ET 
F7ES& 


FTE? 
F7EA 
F7ES 
FT7EC 
FETED 
STE 
FU7FS 
FTFS3 
FTF4 


FTFS 
FTF6 
F7F7 
F7FS 
FTF9 


FU7FA 
FP7 FB 
FT7FG 
F7FD 
FU PFE 
FU7FF 


BABA 


ws 


DTAB 3 


MOY Be & 3 

DAD D r 

DAD D 3 

DAD H 3 

DAD H 3 

MOV As& F) 

SUB H 3 

MOV Boh 5 : 

MY I Ae CVID4+960) AND OFFH 
SUS E Py 

MOV Ea & 3 

BN I Ae CVID*968) SHR & 
SBB 2 F 

MOY Ds A 3 

MOY AeG é 

RAR 5 

QORA E 3 

MOV Bae A 8 


GENERATE BIT MASK 


MOV AsG $ 
RAR 2 
MOV Reb ’ 
RAL £ 
MOV Cah ’ 
MV ft Bs B 8 
LAt HsDTAB 3 
DAD B 2 
MOV Ase lM i 


PREPARE FOR EAIT 


POP H 3 
rOP B 3 
MOV Cal 3 
LDAX D 3 
RET 3 
Da BAH 

Do 20H 

DB G2H 

DS 13H 

Ds 61H 

D3 28H 

END 
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2.0 DESCRIPTION OF A EXAMPLE MONITOR LISTING 
('The care and feeding of the SSM 8080 Monitor'') 


2.1 Loading 


Paper-tape: 


Prom IC's: 


2.2 Execution 


Load the paper-tape into the computer per the separate 
instruction sheet. The monitor will reside in memory 
from F@GB Hex to F7FF Hex. 


Place the eight 1702 PROMs (or two 2708's) into the ROM 
card. Note that the high address is marked on each ROM 
as F®@, Fl, etc. Set the high address of the ROM card, 
so the set of PROMs will address appropriately from FOOD 
Hex and up. 

Card kits are available from SSM to support both the 
1702 & 2708 PROMs. 


MB-3 ROM Board: Mount the 1702's in order into the top 
row of sockets on the board. F@ is the 
first ROM to the left. 


MB-8 ROM Board: Mount the 2708's in order into the fifth 
and sixth socket from the left in the 
bottom row of sockets. FQ@ is the fifth 
socket. 


TTY Version (Suffix 'T'): To initialize and run the *SSM 868% Monitor, 


after loading it into memory, just examine 
address F@@@ and hit the run switch. The 
Monitor will output to port 1 (using port 

G@ as status) the statement MONITOR VI.@ 

and then wait for a keyboard command on port 
i 


Video Version (Suffix ''V''): To initialize and run the *SSM 8886 Moni- 


tor, after loading it into memory, just 
examine address F@@B, set sense switch 

A8 to a one, and hit the run switch. (Do 
not worry, if you don't have a front 

panel or a sense switch at port FF, the 
Monitor doesn't need the sense switch to 
work. The sense switch is only an addi- 
tional feature in the Video software driv- 
er allowing the user to stop or start a 
long listing on the video screen. If you 
don't have a sense switch port at FF, then 
A8 will be a one.) The Monitor will out- 
put to EC@@ (1702 PROM Monitor) or BOGD 
(2708 PROM Monitor) the statement MONITOR 
VI.@ and then wait for a keyboard command 
on port 3 (status port 2, DAV = DQ). 
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2.2 (continue) 


The 2708 Monitor has its video driver changed 
for a VB-1B card at BO@B, instead of EC#P to 
allow a 16K Rom card to be used in the com 
puter with no address conflicts. In the 
Source Listing, starting at address F7@@, 

the label VID is equated to B#SM so some 
bytes will differ from the listing. 


*Note: You must have at least 256 bytes of RAM or more starting at O@09. 
The SSM 8686 Monitor creates a scratch pad table (64 bytes) auto- 
matically at the top of contiguous memory when intialized. 


Address 


F7@C 
F729 
PI Ze 
PIZF 
wey 
F7A4C 
F74D 
F754 
F767 
F77B 
F782 
F783 
F786 
F7SF 
PYLEZ 


Address 


FOB 
F6D6 
F698 
FO@E 
F61¢ 
F616 


2708's 1702's 
byte byte 
Bg EC 
Bu Fg 
Cg Cg 
B3 EF 
B3 EF 
BG Oe 
Bg EC 
B4 FQ 
BA Fe 
B3 EF 
OP De 
Be EC 
BO EC 
B4 FQ 
B3 EF 


To make the Monitor power-up using the Video 
card, instead of the Teletype for an output 
device, six bytes were altered in the 1/0 
tables at F6@@. 


The AC commands have been changed only in 
the Video version of the Monitor, so AC=6 
is the parallel keyboard and CRT and AC=3 
is the teletype. 


Video Version TTY Version 
TF AG 
AD /F 
66 A8 
A8 66 
59 B/ 
B7 59 
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2.3 Example Operation of Monitor (see Example Monitor Listing) 


thee The monitor outputs its name and types a period, when 
executed at FOB Hex. 


eo ses If an asterisk was outputted to the printing device, 
then a character from the input device was not of the 
correct notation expected by the monitor. 


Be The substitute command is now used at address zero 
(S®) and the space-~bar is depressed. The computer 
responds with ''27-'', or any random Hex number that 
happens to be at address $9%%@. The user typed ''C3"! 
to change this byte at address @@0%. If the space- 
bar is hit with no other character typed, then con- 
secutive bytes in memory are displayed without being 
modified. 


Cie A display of memory is made from $906 to OM1F Hex. 
After typing in D@ IF a carriage-return is typed. 
Note: The starting address of each row up to 16 
bytes is displayed on the left, as four hex digits. 


[5]... A fill command is used. Zero's are placed into memory 
from 0210 H to O@1IF Hex. 


[6]... The memory fill command is checked with a display 
command. 


Tete A small program was now written into memory using 
the substitute command. 


Program: 

Address Code Mnevmonics 
PO4D 3E 08, MVI A,@ 

— GG42 B1,02,01 LXt B,@1@2H 
OD45 11,064,683 LX! D,6364H 
GH48 21,086,805 LX! H,@5@6H 
OB4B 31,088,067 LX! sp,@708H 
OO4E C3,40,80 JMP 46H 


_ A display of the small program. 


. A goto command is used to execute the program at $649 
and also one of the two optional software breakpoints 
is set to G48 (see notes in Source Listing). Note: 
The breakpoints will not work on a program in ROM. 
RST | is used for software breakpoints. 


... The program is stopped at *@@46, then the user typed 
"X'' and a carriage-return to display the 8080's reg~- 
isters A thru E,H,L and the flag code ''F'' also the 
memory location (M), program counter (P) and the 
stack pointer (S). 
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2.3 Use of the monitor (continued) 


fa] ... To continue the program, a "G' was 
typed followed by a space and another 
optional breakpoint address was set at 


Ph48. 


fi 2] hace UE step- [3], a jump instruction to the 
monitor was written into memory. Using 
the goto command, the monitor was re-in- 
initialized. 


fi 3} ...- A block of memory data will now be 
changed by using the move command (M). 
Memory data from $$30 to $@3F will be 
placed at $928 and up. 


fi 4) ... A dump is made of the small program 
from $f46 to 0658 in a format compati- 
able with INTEL's paper-tape format. 


fi S| ... Using the "H' command the sum and dif- 
ference of two hex numbers, all the way 
up to FFFF, can be displayed. 


fi ... the user now changed the I/0 configura- 
tion of the monitor. 


AC = 1 Console I = parallel keyboard in. 
Console 0 = teletype for output. 

AR = 1 Reader = Special reader device. 

AP = 2 PUNCH = CRT for a punch. 

AL = 1 LIST DEVICE = CRT for listing. 


3.0 I/0 CONFIGURATION 


The Input-Output configuration is established in tables and 
routines between FO#f to FOFF. There are 6 tables starting 
at F6$ which are for storing the main entry addresses (2 
bytes each) for the routines to Check-status (CSTAB), Input 
data (CITAB), Output data (COTAB), Reader device (RITAB), 
Punch device (POTAB), and Listing device (LOTAB). Typing the 
command AC,AR,AP or AL followed by an equals sign and a num- 
ber will set up an I/0 configuration. The I/0 configuration 
1s coded into just one byte (IOBYT) at the very last byte of 
contiguous RAM. (Top of memory) ee a ear 


The NTOBYT" is broken down into four parts, where every two 


bits represents the binary number zero through three of the 
selected I/O configuration. : 
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3.0 I/0 CONFIGURATION (continued) 


| D7 Dp 


If the Monitor has been initialized and an 1/0 configuration has been 
set~up and you wish to go to the monitor without resetting the I/O, 
then jump to FQ@21. 

3.1 Preset I/0 


The SSM 8080 Monitor comes with the following preset I/0 


configurations: 
: x | : 
Logical Status Status Data Comments 


Command Port | Bits | Port 


AC=9 Main console I/0. 
AC=1 Keyboard input 
Console output 
AC=2 Keyboard input 
Output device 
AC=3 Keyboard input 
memory 
mapped Output to VB-1 
AR=6 pg DAV=D# 1 Console input 
AR=1 4 | DAV=D# 5 Reader 
AR=2 2 DAV=D@ 5 Keyboard. 
AR=3 Vector to read from disk**ICOM Microfloppy 
AP=@ p DAK=D7 1 | Console output 
AP=1 | 4 DAK=D7 5 | Output to punch 
AP=2 Memory mapped I/0 Output to VB-1 
AP=3 | Vector to write on disk | ICOM Microfloppy 
AL=6 — p DAK=D7 | 1 | Console output 
AL=1 Memory mapped I/0 | Output to VB-1 
AL=2 2 DAK=D7 3 Listing Device 
AL=3 p DAK=D7 | 1 | Console output 


*Data-~Available=DAV, Data-Acknow] edge=DAK 
**Trade name of a Floppy~Disk system form ICOM Microperipherals. 
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